home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / EDITORS / OBSCURE2 / !obscure / !helpfile < prev    next >
Text File  |  1992-08-30  |  5KB  |  129 lines
  1. OBSCURE 
  2. =======
  3.  
  4. This program has a few rather strange behavours, but it's made for a rather 
  5. strange thing:
  6.  
  7. It's a commandlineeditor which work inside taskwindows of !edit of RISCOS 2.00 
  8. of Acorn Archimedes.
  9.  
  10. It's much simpler, then the lineeditor of R. K. Llyod, which replaces
  11. OS_Readline, it's only a commandlineeditor which can be used in the CLI-
  12. environment.             ===========
  13.  
  14. Unfortunally, R.K. Llyod's lineeditor work only under the taskwindow of 
  15. RISCOS 3.00 (which is not PD/Freeware/Shareware), if you use VMODE (which is 
  16. PD/Freeware/Shareware). Unfortunally, there are problems running floating-
  17. point-programs running inside the taskwindow of RISCOS 3.00 under RISCOS 2.00.
  18.  
  19. Cause I prefer to work with the keyboard, but not with the mouse and often use
  20. unixtools, I real need a taskwindow with a commandlineeditor.
  21.  
  22. The following things are very difficult/impossible in the taskwindow of !edit of
  23. RISCOS 2.00:
  24.  
  25. 1. it's difficult to start programs automatic with the start of the taskwindow
  26. 2. you can't move the cursor with VDU -commands
  27. 3. it's difficult to detect arrow-keys in a proper way
  28. 4. it's impossible to use the mouse-related operations of !edit
  29.  
  30. cause of this things there are a few strange behavours in the program:
  31.  
  32. cause of 1.
  33.    you have to start the program as the first command in the taskwindow
  34.    with typing "cled" (CommandLineEDitor) (if this is too long for you, use
  35.    set alias$whatever cled) (type "quit" if you want to end the program)
  36.    A patch of the taskwindow-module would be necessary to do this automatical,
  37.    but this is very difficult (but I heard about a patch, which heal the 
  38.    CLI$Prompt-bug, but don't know who wrote it...) 
  39.    I also included a command in the !run-file of !obscure to start "cled" 
  40.    with pressing function-key 10 (and a command for "quit" with function-key 3)
  41. cause of 2.
  42.    the program don't use the cursor, it uses in insertmode ☓ and in 
  43.    overwritemode ⇨ ⇦ instead. Positionating of the cursor-replacing characters
  44.    work with echoing ascii 127 and then redrawing. Therefore positionating 
  45.    may be slowly.
  46. cause of 3.
  47.    Detecting arrow-keys without mapping them to key$number is difficult.
  48.    unfortunally, the insert-key gives the same key$ -value as one of the 
  49.    arrow -key, therefore toggle insert and overwrite-mode with the copy-key 
  50. cause of 4.
  51.    Copying screencontence not available (neither via mouse nor via copy-key)
  52.  
  53. ****************************************************************************
  54. IMPORTANT: USE quit   BEFORE YOU CLOSE THE TASKWINDOW
  55. ****************************************************************************
  56.                     ^(or the mathing functionkey)
  57.  
  58. Don't forget this, otherwise will !edit keep the memory of the wimpslot of 
  59. taskwindow.
  60. ______________________________________________________________________________
  61.  
  62. short discription of commands (each must be typed in lowercase):
  63.  
  64. cled    starts program
  65. history reviews available commands
  66. quit    ends program 
  67.  
  68. go left : ⇦ -key
  69. go right: ⇨ -key 
  70. go down : ⇩ -key
  71. go up   : ⇧ -key
  72. toggle insert/overwrite mode: copy -key 
  73.  
  74. help obscure :shows copyright information
  75. help cled    :shows command-discription
  76. _______________________________________________________________________________
  77.  
  78.  
  79. Bugs: Each parallel invokation of 'cled' clones the main part of the program.
  80.       This claims memory in the RMA with OS_Module. If the clone 'quit's,
  81.       the memory is freed with OS_Module. Cause the OS_Heap memory-management
  82.       makes no proper garbage-collection, this may result in a (each 16K long)
  83.       blank space in the RMA.
  84.  
  85.  
  86. COPYRIGTH NOTICE
  87. ================
  88.  
  89. This program is (a sort of) Shareware, Copyrigth © 1992 MUFTI
  90. You can copy it to any media, but you may not sell it.
  91. You may use it under the following condition:
  92. If you are the programmer of a PD/Freeware/Shareware 
  93.  
  94.    computer-language-related
  95.    editor-related
  96.    unix-tool-related
  97.    TeX-related 
  98.  
  99. program for acorn machines, you must distribute a copy of the program on the
  100. ftp/mail-server rusmv1.rus.uni-stuttgart.de (if the program isn't already there)
  101. Use a unixcompatible Archive, like cark-compatible archives or .tar.Z archives 
  102. There are 3 ways to bring the program to there:
  103.  
  104. 1. via E-Mail to zrzm0370@rusmv1.rus.uni-stuttgart.de or (if this service is 
  105.    closed) to burr@rus.uni-stuttgart.de
  106.  
  107. 2. via MSDOS-discette (there are PD/Freeware/Shareware MSDOS-discette writers)
  108.    (or standard UNIX-tape) via Snail-mail to
  109.  
  110.    Rechenzentrum Universitaet Stuttgart
  111.    Acorn-Directory-Betreuung bei Fr. Burr 
  112.    Allmandring 30a
  113.    7000 Stuttgart-Vaihingen 80
  114.  
  115. 3. via ftp to the directory /soft/acorn/incoming
  116.  
  117. if you are not a programmer of such a program, you may use the program without
  118. paying/doing something.
  119.  
  120. so long
  121. MUFTI
  122.  
  123. (currently zrzm0111@helpdesk.rus.uni-stuttgart.de) 
  124.  
  125.  
  126. ps:   'rmload' the module, 'rmrun' will invoke it. 
  127.  
  128.  
  129.